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INTRODUCTION 

»» 

This manual is used in conjunction with the Atari 
Assembler Cartridge. To use the Assembler Cartridge and this 
manual you should already have the background described below. 

1. BACKGROUND YOU NEED 


A. You should be familiar with the general capabilities of the Atari 400/800 
personal computer and familiarity with its keyboard and all screen-editing 

■v 

functions. This material is covered in the Operators' Manual supplied with 
the 400 and the 800. 

B. You should have a working knowledge of 650x assembly language , including 

knowledge of the effect of every instruction. This may be obtained from several 
sources. There is a high degree of standardization of 650x Assembly Language 
i mnemonics. There is more variation in ways of writing operands. 

A complete summary of instructions is given in Appendix A. Seme 
descriptions in this manual take the form of a reminder or brief review and 
assume that the reader is already familiar with the subject. 



C. Finally, if you are using the Assembler Cartridge in a system with diskette 
drive, you diould have practical knowledge of the Atari Diskette Operating 
System (DOS) . 


l.b.l 

l.a.l 
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Most users of the Atari 400/800 computers will program in Atari 
BASIC, the standard high-level interpretive language supplied with 
the computer . BASIC translates instructions into machine code a 
line at a time. BASIC is inefficient in two senses: it does not 
execute quickly and it is "wasteful" of memory. If you need to 
have a process caried out more efficiently than can be achieved in BASIC, 
then you should use Assembly Language. 

In many applications it may be satisfactory to write most 
of your program in BASIC and write critical parts of it in 
Assembly Language. The Atari BASIC manual gives an example 
of this facility, with the USR Function of BASIC. 

_ You should read this manual straight through. You will need 
most of the information presented. The manual is organized 
so that it may serve as a convenient reference book after you have 
acquired facility with the Assembler. 

* 

2. THE ASSEMBLER CARTRIDGE 

Hie Assembler Cartridge contains three separate programs, 
called the WRITER/EDITOR, ASSEMBLER and DEBUGGER. 



u/fS) 

You write Assembly Language programs with the help of the WRITER/EDITOR. 

You then assemble your program ( translate into machine language ) with th r ' (y* 

ASSEMBLER. To modify the program you use the WRITER/EDITOR or the DEBUGGER. - . v 


/ 


To test or trace the actual operation of your program you use the DEBUGGER. / 
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3. WHAT YOU OUGHT TO HAVE TO USE THE ASSEMBLER CARTRIDGE 


J 

To take advantage of the Assembler Cartridge, it is essential to 


I 

posses only the 400 or the 800 and the Assembler Cartridge itself. \ 

^ j 

However, without a permanent storage device you will have to alter your 
program on the keyboard each time that you wish to use it. This can 
be so tedious that a cassette recorder or a diskette drive is a practical 


i t >*/ ' 

if C 


necessity, 


The 410 cassette recorder is supplied with the 800 system, but we 
do not recommend its use with the Assembler Cartridge. We recommend 
that a diskette drive, the Atari 820, be used to provide permanent 
storage of .programs. 


A diskette drive requires a Diskette Operating System, which needs 
at least 16k of memory. Consequently, your Atari 400 cannot use a 
diskette drive unless you upgrade your computer from 18k to 16k of 
memory. 

The Atari 820 Printer is an optional addition to your system. 

It will allow you to keep a record of your programs in a form that you 
can read. 


'fij 
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Figure “1. The ^elements of the system recommended for using the Assembler Cartridge. 
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S» I The 6502 Micro processor 
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The 6502^p 


rocessor is represented in Figure 2 
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{ Accumulator (A)/ ^ 

C ) 


INDEX REGISTER X 


INDEX REGISTER Y 
PROGRAM COUNTER (PC) 
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STACK POINTER (S) 


PROCESSOR STATUS REGI 



(P) 


C, Carry l=True 

Z, Zero l=Result is zero 

I, IRQ Disable l=Disabled 

D, Decimal Mode l=Decimal Mode 
B, Break Command 


V, Overflow l=Overflow 

N, Negative l=Result is negative 



* 1 * 


\ 

Figure 2. The 6502 Microprocessor from the Programmer's Point of View. 
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The A register is referred to as the Accumulator. The Registers X and 
Y are Index Registers used as scratch pads and in certain addressing modes, 
as explained later (See Addressing Modes) The Program Counter is the 
counter incremented as each instruction is fetched and executed. The 

numbers it contains correspond to the locations in memory of successive 

\ 

instructions. 

The Processor Status Register is updated after execution of each 
instruction, according to the effects of the instruction. Memory consists 
of 64k possible locations addressable by the Program Counter. 

Not all of these 64k locations are available in an actual system. 

That is because sane addresses are in RAM, and some are addresses 
of devices in the oomputer. The allocation of addresses is given 
in Appendix B. 

The Stack occupies memory from 01 FF down to 0100. Four special 
instructions access the stack. The stack pointer register always 
points to the top of the stack. 

You can specify or determine the contents of all registers and 
all memory locations by Assembly Language instructions. It is as- 
sumed in this manual that you already know how to manipulate numbers 
in this manner. 
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5.2 PROCESSOR STATUS FLAGS 

• V 

Seven specific effects of an instruction are stored in the Processor 
Status Register (Register P) as each instruction is executed. The bit 
position of the effect is shown in Figure 2. Each bit is also called a flag. 
The presence or absence of an effect is shown by whether the flag is set 
to 1 or 0. The flags are called CARRY, ZERO, INTERRUPT, DECIMAL, BREAK, 
OVERFLOW and NEGATIVE, abbreviated C, Z, I, D, B, V and N. 

There are two instructions that affect the stack and also determine 
the content of Register P. These two instructions are PLP (PULL REGISTER P) 
and RTI (RETURN FROM INTERRUPT). In the course of execution of each of 
these instructions a byte is pulled from the stack on to Register P. The 
usual purpose is to restore Register P to sane previously saved value. 

It is understood that the two instructions may change the value of every 
condition flag. 



C FLAG (CARRY) 

The Carry flag is modified when certain arithmetic operations generate 
a carry. The flag can also be set and cleared by direct instructions. 

In the case of shift and rotate instructions, the carry bit is used as a 
ninth bit in a manner similar to the carry of arithmetic operations. 

Instructions to set and clear the Carry flag are . 

SEC SET CARRY 
CLC CLEAR CARRY 


Other instructions whose execution may affect the Carry are 

ADC ADD WITH CARRY 
SBC SUBTRACT WITH BORROW 
CPX COMPARE WITH X 
CPY COMPARE WITH Y 
CMP COMPARE 
ASL SHIFT LEFT 
LSR SHIFT RIOH* 

ROL ROTATE LEFT 
ROR ROTATE RIGHT 


l.b.15 





. B FLAG (BREAK) 

The Break flag is set and cleared only by the processor. It is 
used during an interrupt-service. :routine to determine 

whether the interrupt was caused by an interrupt signal or by 
a BREAK instruction # 




J 


I FLAG (INTERRUPT DISABLE) 

The Interrupt Disable flag is set and cleared by the processor 
in the course of controlling operations that requirej^fie processor 

a 

not be interrupted.- i " - - There are also 

instructions to set and clear the flag directly. While the 
flag is set to 1 the processor ignores interrupt requests. 

v 

'V 


The Interrupt Disable flag is affected by the hardware devices 

in the system, as part of the process of controlling communication 
between elements of the system. The I flag is also affected by the 
instructions PLP and RTI. 

Instructions to set and clear the Interrupt Disable flag are 


SEI SET INTERRUPT DISABLE 
CLI CLEAR INTERRUPT DISABLE 


V FLAG (OVERFLOW) 


JM: 


If you require sign information in the result of an arithmetic 
operation, you use bit 7. In order to be able to interpret correctly 
bit 7 in the result of an arithmetic operation you need to know 
whether two addends with bit 7=0 gave a result with bit' 7=1, or 
vice versa. In these cases the V flag is set. The V flag 
being set indicates that you must use a sign correction routine. 

The V flag is also affected by the BIT instruction. The BIT 
instruction, which may be used to test unknown byte patterns, allows the 
V flag to * show the value of bit 6 in the tested byte. 

V’/fl When used in this way the V flag gives no arithmetic information 
it is simply the value of bit 6 of the operand of the BIT instruction. 


There is no instruction to set the V flag. The instruction to clear 
the flag is 

CLC CLEAR V FLAG 


Other instructions which may affect the V flag are 

ADC ADD WITH CARRY 
SBC SUBTRACT WITH 30RRCW 
BIT BIT TEST 
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Z FLAG (ZERO) 

• * V 

\ 

* v. 

The Zero flag is set by the processor during any data movement or 
calculation when the 8 bits of the result of the operation are zero. 
Therefore, the flag is set (1) when the result is 0 and cleared (0) 
when the result is not 0. This feature of the processor permits a 

sinple test for completion when iterating a specific number of times. 

* 

There are no instructions that directly set or clear the Z flag. 


Instructions whose execution may affect the Z flag are 



LDA LOAD ACCUMULATOR 

LDX LOAD X 

LDY LOAD Y 

ADC ADD WITH CARRY 

AND AND WITH ACCUMULATOR 

INX INCREMENT X 

INY INCREMENT Y 

INC INCREMENT 

DEX DECREMENT X 

DEY DECREMENT Y 

DEC DECREMENT 

ORA OR WITH ACCUMULATOR 

EOR XOR WITH ACCUMULATOR 

SBC SUBTRACT WITH BORROW 

CMP COMPARE WITH ACCUMULATOR 

CPX COMPARE WITH X 

CPY COMPARE WITH Y 

ASL SHIFT LEFT 

LSR SHIFT RIGHT 

ROR ROTATE RIGHT . 

BIT BIT TEST 

TAX TRANSFER A TO X 

TXA TRANSFER X TO A 

TAY TRANSFER A TP Y 

TYA TRANSFER Y TO A 

TSX- TRANSFER S TO X 

PLA PULL STACK TO ACCUMULATOR 



I 


N FLAG (NEGATIVE) 

* 

The^N flag is set to the value of bit 7 of the number that 

results jL)*' all data movement and arithmetic operations* One 
consequence of this, for example, is that after an addition in 
signed arithmetic you can determine the sign of the result 
directly rather than devising a way to find the 
value of bit 7 of the result. 


All operations that involve data movement into Register A, X and Y 
affect the N flag, so it is very widely used as a test condition 
to determine the completion of a process or the existence of a 



in conjunction with the branch instructions BMI and BPL. 

It is as useful iiwthis fashion as the Z flag. Like the Z 
flag, the N flag . only reflects the results of processor 

operations and there are no instructions that set or clear 


the flag directly. 

/***! 

The instructions that / affect the N . flag are 

LDA LOAD ACCUMULATOR 
LDX LOAD X 
LDY LOAD Y 
ADC ADD WITH CARRY 
AND AND WITH ACCUMULATOR 
INX INCREMENT X 
INY INCREMENT Y 
INC INCREMENT 
DEX DECREMENT X 
DEY DECREMENT Y 
DEC DECREMENT 
ORA OR WITH ACCUMULATOR 
EOR XOR WITH ACCUMULATOR 
SBC SUBTRACT WITH BORROW 
CMP COMPARE WITH ACCUMULATOR 
CPX COMPARE WITH X 
CPY COMPARE WITH Y 
ASL SHIFT LEFT 
LSR SHIFT RIGHT 
ROR ROTATE RIGHT 
BIT BIT TEST 
- TAX TRANSFER A TO X 
TXA TRANSFER X TO A 
TAY TRANSFER A TP Y 
TYA TRANSFER Y TO A 
TSX • TRANSFER S TO X 
PLA PULL STACK: TO ACCUMULATOR* ” 




15 


5.3 ADDRESSING MODES 

An instruction, according to a useful and widely-used concept, 
specifies an operation, together with directions to identify the data. , 

subject to the operation — the operand. For example, a particular 

« 

instruction is 
IDA 3333 

The operation is loading a number into the Accumulator; the number to 
be loaded is in address 3333. 

In the next example, the operation is still loading a number into 
the Accumulator, but the number to be loaded is given directly. 

IDA #29 

There are many possible methods of specifying the data to be 
operated cn. Though there are many cannon methods, different proces- 
sors use different methods. The methods are classifiable in various 
‘ ways, too. Each different class of method is usually referred to as 
an addressing mode . In sane cases, classes referred to as addressing 
modes are ways distinguishing types of operand , or ways of interpreting 

an operand. 

The address that contains the number that is operated on is called 
the effective address. In all modes of addressing except IMMEDIATE it 

* 

is the number in the effective address that is added, subtracted, 
rotated, etc. 

We give a list of addressing modes below. This is virtually the • 

same as a list of types of operand. After the list of addressing modes 

yiQ give a list of ways that different operands are written. 

In addresses given by bytes 2 and 3 of an instruction, byte 2 gives 

the low address and byte 3 -gives the high address. 

Addresses said the be given by byte 2 of an instruction are presumed to be 

OOOx - that is, in Page Zero. 
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5.3,1 NON-INDEXED ADDRESSING MODES * 

IMMEDIATE The operand is byte 2 of the 2-byte instruction. 

PACE ZERO The effective address is the address given by byte 

2 of the 2-byte instruction. Since the high 
address is presumed to be zero, the effective 
address is in Page Zero. 

ABS0U7TE The ffective address is byte 2 (low address) and 

byte 3 (high address) of the 3-byte instruction. 


5.3.2 INDEXED ADDRESSING MODES 


ABSOLUTE INDEXED The effective address is determined as for 

Absolute Addressing, with the addition of the 
number in Register X (Absolute, X) or Register 
Y (Absolute, Y) to the Absolute Address. 


INDEXED INDIRECT [(Indirect, X)] The effective address is the 

2-byte number starting at the address given 
by byte 2 of the instruction plus the number in 
Register X. (Always Page Zero). 


INDIRECT INDEXED [( Indirect ) ,Y] The effective address is the base 

address plus the number in Register Y. The base 
address is the 2-byte number starting at the address 
given by byte 2 of the instruction. (Always Page 
Zero ) . 


INDEXED ZERO PAGE [Z Page, X; Z Page, Y] The effective address is 

the address given by byte 2 of the instruction plus 
the number in Register X or Y. 


5.3.3 MISCELLANEOUS ADDRESSING MODES 

" » 

j 

I 

REGISTER The effective address is Register A (Shift and Rotate 

instructions) or Register X or Y (Increment and 

Decrement instructions ) . i 

| 

| 

IMPLIED The effective address is the Register, the stack or a 

flag, as implied by the operation. I 

RELATIVE Byte 2 of the instruction is added to the Program 

Counter. 

INDIRECT The effective address is the 2-byte address starting 

at the location given by bytes 2 and 3 of the instruction. 

» * 

NONE Machine control operations (HLT, NOP) do not address data* 
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6 , PROGRAM FORMAT— HOW TO WRITE A STATEMENT 


ft I 


A program to be assembled is called a source program. It consists 
of Statements. Each Statement is terminated with RETURN. A Statement 
must be 1-106 characters. 


The Assembler interprets parts of a Statement in one of five 
different ways — as a Statement Number, Label, Operation Code 
Mnemonic (or Directive), Operand or Comment. These occupy different 
character positions in the Statement, Statement Number first and 
Comment last. The positions occupied by the different parts of a 
Statement are called "fields". 


STATEMENT NUMBER Every statement must start with a number 
from 0 to 65,535. We recommend that Statements be numbered 10, 

20, 30, etc. The WRITER/EDITOR puts the Statements in numerical 
order. Numbering by 10s allows you to insert new Statements in 
later versions of a program. In addition, the WRITER/EDITOR has 
convenient commands for numbering Statements (See NUM,REN). 

LABEL A Label is entered on the left-most position of the V 
screen, after the Statement Number. You must leave exactly one 
space (not a tab) after the Statement Number. The Label must start 
with a letter and contain oily letters and numbers. It can be as 
short as two characters and as long as the limitation of Statement 
length permits (107 less the number of characters in the Statement 
Number) . 

You are not forced to have a Label. To go on to the next 
field, enter another space (or a tab). The Assembler will interpret 
the entries after a tab as an Operation Code Mnemonic. 


OPERATION CODE MNEMONIC The Operation Code (or Op Code) Mnemonic 
must be cne of those given in Appendix A. It must be entered in the 
, field that starts at least two spaces after the Statement Number, 
or after a Label. An Operation Code Mnemonic in the wrong field 
will not be identifed as an error in the Write/Edit mode, but will 
be flagged when you assemble the program (Error 6). 


OPERAND The field of the Operand starts at least one space 
(or a tab) after an Operation Code Mnemonic. Some Operation Codes 
Mnemonics do not require an Operand. The Assembler will expect an 
Operand if the Op Code Mnemonic requires one. The 
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form of the Operand that is appropriate to each Operation Code Mnemonic 
is given in Appendix A and each different way of writing an Operand is 
given in the section called HOW TO WRITE OPERANDS. 


COMMENT A Comment appears on the listing of a program, but does 
not figure in the assembled form. ^ 4 -? 


There are two ways to have the Assembler interpret entries as Comments. 
One way is to make the entries in the Comment field, which occupies the 
remainder of the line after the instruction field(s). At least one space 
must separate the fields. There may not be enough space in the Comment 
field for the Comment you wish to write there. In that case you can extend 
your Comment into the next line. If you wish to number that line, you will 
have to use the second way to signal the Assembler that your entries are part 
of a Comment. To do so, you enter one space and a semi-colon after the Line 
Number. The Comment so entered need not be a continuation of the Comment on 
the previous line. Everything between the initial semi-colon and the RETURN 
is ignored by the Assembler, but will be printed in the listing of the program. 


The Statements below show various examples of Comments correctly 
positioned in the Statement. 


210 LABL LDX ABS COMMENT IN COMMENT FIELD 
220 TSX COMMENT IN COMMENT FIELD 
230 PHP COMMENT IN THIS LINE OONT 
240 ;INUED CN THIS LINE 
250 LDY #FF 

260 ; COMMENT CN ITS OWN LINE 
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HOW TO WRITE OPERANDS 


This section shows how to write operands. The examples use State- 
ment Number 10 (also called Line Nunfcer 10). A Statement Number is used 

because an instruction entered without a Statement Number is not allowed 

% 

by the WRITER/EDITOR. 

The examples use "BY and and "ABS" as a one-byte and a two-byte number, 
respectively. This use implies that the program includes definitions of 
BY and ABS as, for example: 

100 BY-155 
200 ABS=567 

* 

♦ 

Please refer to the description of the = Directive for an explan- 
ation of the definitions of lines 100 and 200. 
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Hex Operands 


A number is interpreted as a decimal number unless it is preceded 
by "$", in which case it is interpreted as a hex number. 


Examples : 

10 STA $9325 
10 ASL $15 
10 CPY ABS- 


Immediate Operands 

An immediate operand is an operand that contains the data of 
the instruction. The pound sign (#) must be present to indicate an 
imnediate operand. 

Examples : . • , 

A- 

10 LDA #12 
10 ORA #$3C 

10 CPY #BY - /.v, /< . *>■ 

Absolute Operands 

Absolute operands are evaluated as 16-bit numbers. 


Examples : 

10 LDX $1212 

10 CPY 2345 

10 DEC 579 

10 BIT ABS 
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An Absolute Indexed Operand uses Register X or Y. The operand 
is written ,X or — ,Y 

Examples: . 


10 AND #3C26yX 
10 EOR 20955, Y 
:i0 STA ABS,Y 


t 
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Indexed Indirect Operands 

An Indexed Indirect instruction uses Register X. The operand 
is written ( — ,X) 

Examples : 

10 INC ($99,X) 

10 ADC (BY,X) 

Indirect Indexed Operands 


An Indirect Indexed instruction uses Register Y. The operand 
is written ( — ),Y 

Examples: 

10 IDA ($2B),Y 
10 CMP ( $E5) ,Y 
10 ORA (BY) ,Y 


Indexed Pace Zero 


A Zero Page Indexed operand is written — ,X or — ,Y 

1 

Examples : 

i 

10 INC $34, X 
10 STX $AB,Y 
10 LDX BY,Y 
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String Operands 


Operands or parts of operands enclosed in double quotation marks 
are translated into the ATASCII numbers of the characters between 
the quotation marks. The instuction or Directive must be 
appropriate * 

Examples : 

10 ADDR .BYTE "9+1 =S TEN" 

Execution of this Directive causes the ATASCII numbers corresponding 
to "9", etc., to be stored at successive locations starting at ADDR. 
Note that the ATASCII representation of any character except the quota- 
tion mark (") can be stored with the .BYTE Directive having a string 
operand. 
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PROGRAMMING 


Your intial contact with the Assembler Cartridge is with 
the WRITER/EDITOR. The purpose of the WRITER/EDITOR is to receive 
and retain what you enter on the Keyboard and to follow your 
instructions to modify what you previously wrote* 


1. CALLING THE WRITER/EDITOR AND OTHER CONTROL PROGRAMS 




In order to use the WRITER/EDITOR ( or any other cartridge 
program) it must be called, or "invoked". That is, the program 
that will control the comm unicat ion between you, at the keyboard, and the TV 
screen, must be the WRITER/EDITOR and not some other program. 


Only one of five programs (four if you do not haye a diskette drive) 
can be in control if you are using the Assembler Cartridge. They are the 
WRITER/EDITOR, DEBUGGER, ASSEMBLER, DOS and MEMO-PAD? T he - MINI -A SSEMBL ERr 
-acco c s ibl o cnl y— from - the — DEBUGGE R ,- oou ld b e c o nsi dered a ■ si x th— program^ The 
keyboard entries that will transfer control from one of these to another are shown 
in Figure 3. 



Figure 3. The control programs possible with the Assembler Cartridge, and how 

to transfer from one to another. "(R)" signifies RETURN. 



MEMO PAD 


MEMO-PAD is the name given to the control rode when no cartridge is 

Therefore, when you see "MEMO-PAD" on the screen and you cannot get 

out of it by depressing the system reset key, you have either failed to insert 

the Assembler Cartridge or you have not properly seated the cartridge in its 
socket. . 

k 

If the cartridge is properly inserted, you can transfer into MEMO PAD by 

typing BYE (RETURN) . You can transfer from MEMO-PAD back to WRITER/EDITOR by 
depressing the SYSTEM RESET key. 

All the screen-editing functions operate in MEMO-PAD, so you can compose the 
screen. The text on the screen is stored in a temporary buffer and cannot be trans- 
ferred to a permanent storage medium. Since the screen in MEMO PAD is kept in- 
dependent of any program you are writing in the Write/Edit node, MEMO PAD is a 
convenient mode to use when you must interrupt a programming task. You can leave a 

message cn the screen as a reminder to yourself or as information for others. 

For example , 

ATARI COMPUTER - MEMO PAD 

t . 

* 

GONE TO UUNCH. BACK AT 1.15 
PLEASE DO NOT ERASE [] 
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DOS is the Disk Operating System used with an Atari computer having at 
least 16k of memory. It is supplied with the Atari Diskette Drive. The DOS 
is written cn a system diskette. Its function is to manage data transfers 
to and from a diskette cn which you wish to save data. When the diskette 

drive is pcwered up and the system diskette is loaded/ powering the 

; ;; * - • 7r "> : / 

computer will cause the DOS to be loaded into RAM. Seme of the DOS 
facilities can be used by the WRITER/EDITOR to permit access (read/write) 
to diskette. When you transfer to DOS, by entering DOS (RETURN) , you can 
read/write cn diskette independently of the Assembler Cartridge. For a 
detailed understanding of DOS, refer to the DOS manual supplied with the 
diskette drive. 

DEBUGGER ^id^INI -ASSEMBLER ^ 

The DEBUGGER, entered by typing BUG (RETURN) , has many commands that 
enable you to examine details of your assembled program. From the 
DEBUGGER you can enter the MINI -ASSEMBLER, which allows you to write 
instructions in Assembly Language and have each instruction assembled 
immediately* 



. , j 

' 

I 

. 

WRITER/EDITOR and ASM 

■ ** 

It is clear from Figure 3 that when using the Assembler Cartridge you are 

normally in the Write/Edit mode or the Debug mode. When 

' 

1 

the Atari 800 is powered up with the Assembler Cartridge installed, control is 

automatically transferred to the Write/Edit mode. The screen will show this by 

' 

writing EDIT on the top line and the cursor, a solid square filling one char- 

. 

acter space, on the next line. ! 

* 

-v I 

You transfer into the Assemble mode only from the Write/Edit mode (type 
the conmand ASM) and the return from the Assemble mode is automatic when 

assembly of the program is complete. 

. 

The Assemble command (ASM) has three parameters not shown in Figure 3. 

i 

If you do not specify the parameters, the Assembler assumes standard values. 

The ASM command is more fully described in the section on Saving and Retrieving 
Commands. 


l.b.6 

l.a.6 only 
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Having powered up your 400 or 800 with the Assembler Cartridge 

installed, you should see on your screen the message 

* 

EDIT 

* 

With your diskette drive connected you will have to wait a few 

/ <i 

seconds while DOS is loaded frctn diskette into RAM. If you have the 
diskette drive connected and powered, but you have no diskette running, 
the system will be unsuccessful in attempting to boot the diskette 
drive. Consequently, you will rec eive the normal Boot Error message 
on the screen. You can avoid this by pressing the SYSTEM RESET key, 
and the EDIT message will appear immediately. You can also prevent the 
system from attempting to boot the diskette drive by either disconnecting 
the drive from the aonsol or by powering down the drive. 

f 

Once the EDIT message appears, any entries on the keyboard will 

appear in successive locations across the screen, starting at the 

¥ 

cursor ( [] ) position. The screen is 36 locations wide, and there is 
an automatic "wraparound" when you come to the end of a line, so that 
your entries automatically continue cn the next line. A J 

The EDIT message tells you that you are in the Write/Edit mode. 

If you do not see the EDIT message, sane error or malfunction has 
occurred. You siould check the Operators Manual to make sure that 
you have followed procedures correctly. 
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2. GETTING STARTED 

In this section we explain three "getting started" commands, 
namely SIZE, LOMEM and *=. 

Certain decisions have to he made before a single Assembly 
Language instruction is assembled. These decisions have to do with where 
various aspects of the information to be generated will be stored. The 
decisions are already constrained by the demands of the rest 
of the system. We have to explain how the system handles your input 
from the keyboard. 

Your input from the keyboard goes to two locations : 

1. CURRENT LINE BUFFER. This is a short buffer of 108 locations in 
which the characters of the current line, up to a Return, are stored 

in AIASCII form. The line can be 106 characters long, including the Line 
Number at the beginning of the line. The buffer is overwritten by 
each successive line. It is located in a scratch-pad area of 484 
locations (180 hex) reserved for the Assembler Cartridge. 

2. EDIT TEXT BUFFER. This buffer starts above the Assembler scratch-pad 
area. It stores, in ATASCII form, all the input from the keyboard. 

The information displayed on the screen when you are writing a program cones 
from the Edit Text Buffer. When you alter a line on the screen, by using 
the keyboard editing functions and RETURN, you also alter what is stored in 
the Edit Text Buffer. 

As you enter more and more on the keyboard, the Edit Text Buffer 
fills up. There is no upper bound specified. However, it is possible 
to attempt to make the Edit Text Buffer extend into non-existent memory 
or into memory reserved for the OS. 
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The remaining locations between the top of the Current Line Buffer and 
the bottom of the Edit Text Buffer are scratch-pad RAM used by the 
Assembler Cartridge . 

SIZE Command 

To find the location of the Current Line Buffer and the Edit Text 

Buffer, type the' Ccrmand SIZE. Three hex numbers will be displayed, as 
follows : 

EDIT . 

SIZE (RETURN) 

0700 0880 5C1F 

EDIT 

[] 

The first number (0700 in this example) is the start of the Current 
Line Buffer. The middle number (0880) is the start of the Edit Text 

Buffer. These numbers are larger when DOS is loaded from a system diskette 
on power-up. 

If SIZE is the first command (and you have not entered anything 
else cn the keyboard), then the second number will be 180 (hex) larger 
than the first. The second number gets larger, however, as you enter 
text on the keyboard. The second number is actually the address where 
the next character you type will be stored. 

You can find out at any time how long your program is with the 
SIZE command. Subtract the first number and 180 from the second number. 

The result is approximately the number of characters in your program. 

t * 

The third number (5C1F) is the highest available memory location . 

. - - • T 

It depends on the type and quantity of memory boards in your oomputer. 

Thus, all three numbers differ according to the configuration of your 
system. However, they are always the same (at the start of a program) 
until you change them, as described next. 


w 


) 


LOMEM Command 


You can change the location of the buffer area by the LOMEM Command* 
The locations of the Assembler scratch pad, including the Current Line Buffer , 
and the Edit Text Buffer, are moved by a single command. The command has 
the form LOMEMxxxx. * For example, the command 


LOMEM1234 (RETURN) 

changes the Current Line Buffer (the start of the scratch-pad area) to 1234 hex 
and the start of the Edit Text Buffer to 13B4 hex~ (1234 + 180) . 

You can verify this by entering a SIZE Command after the LOMEM Command. 

You must not . choose a LOMEM address lower than the lowest address shown by 

*• 

the SIZE Command. If you did choose a lower address, your buffers would write 
over some of the memory reserved for the Operating System. The lowest 
address that the Command LOMEM will show is 0700 (bex)^. 

One example -of the use of the LOMEM Command is to reserve memory in the 
area of the normal (default) location of the Assembler scratch pad. 

Consider the following commands: 

SIZE (RETURN) 

0300 0880 5C1F 

EDIT 

Q 

(POWER OFF, POWER ON) 

EDIT 

LOMEM 800 
EDIT 

a 


The effect of the LOMEM Command in this example is to permit you to use 
in your assembled program the 256 locations from 0700 to 0800. 

You cannot change the location of the buffers after you have started 
writing a program. If you use LOMEM, it must be the first command after 
you power up. Thtla is why power* was switched off and on after the SIZE 
Command in the example, above. 




•i* 


*= Command 


~Y* 


3 / 


ft 
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By using the SIZE command you know where your program, as entered 
on the keyboard, will be stored, but you must also specify where the 
program, as translated into machine language, will be located. The 
Assembler must know where the machine language equivalent of the very 

first instruction must be located. Therefore, a starting location must be 

* 

specified before the first Assembly Language instruction. This is done 

with the *= Command. The command corresponds to ORG in some other assemblers. 

« 

The *= Command must have a Line Number followed by a least 2 spaces to be 
out of the label field. It must be written as shown, without a space 
between * and =. 

* 

Example : 

EDIT 

10 *=$5000 
20 TAX 

30 ... 

The effect of line 10 is exerted when the program is assembled. 

The effect is to place the number AA (the code for TAX) in location 
$5000, and subsequent instructions in successive locations. 

The *=Cannand should appear before the first Assembly Language 
instruction, but it can also be used anywhere in your program to change 
the Program Counter. For example, to reserve four locations after line 
120, write: 

121 *=*+4 (RETURN) 

The initial *=Command may actually be the one that is written last. 

After you have finished writing your program, you may determine the top 
of your Edit Text Buffer with a SIZE Canmand. For example. 
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SIZE (RETURN) 

2800 ' 346F 9C1F 


EDIT 

I 


That tells. you that it is safe to assemble your program between 
3470 and 9C1F, so that you might then add to your program line 0. 

0 *=$3500 (RETURN) 

In this fashion you add to the beginning of your program a state- 
ment that guarantees that the ASSEMBLER does not overwrite your source 
program. The difference between $3470 and $3500 gives you a margin 
for any minor debugging changes that increase the length of your 
source program. 

CAUTION If you neglect to include a *= Command, the ASSEMBLER will attempt 
to assemble your program starting at address 0000. Your program will 
start to be assembled in Operating System RAM, changing data that the 
Operating System needs to function properly. 
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We are now ready to give a small sample program to show the LCMEM, 
SIZE and *« Ccmnands, the recommended spacing when you enter your program 
on the keyboard , and the pacing of the assembled program on the screen. 


Figure 4 represents the appearance of the screen as you enter your 
program and after you give the ocmmand to assemble (ASM) . Only 24 lines 


everything 


be on the screen at the same time. 


EDIT 

LOMEM5000 


** x S 
J. ' * 



EDIT 

SIZE 

- ' 

5000 

• 

EDIT 
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ASM 
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.. SAME PAGE . 
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Figure 4. Appearance 
(above) and assembled (below), 
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Referring to Figure 4, note the following points: 

1* The Canmands LOMEM, SIZE and ASM do not have Statement Numbers* 

2* All instructions and Directives have Statement Numbers* 

3. A Label starts after one blank space following the Statement Number 
(e*g.. Statement 20)* 

4 

4. An instruction or Directive starts after two blank spaces following 
the Statement Number (e.g.. Statements 10, 30, 40, 50, 80) 

5. Single spaces separate Label, Op Code Mnemonic, Operand and Comment 
(e.g., lines 20 and 30). 


6. Using Statements 20 and 30 as examples, the format of the assembled 
program is shown below. Note, however, that some of the spacing can 
be change by the TAB Directive (q.v.). 


3000 AE4437 20 REP 
3003 F064 


LDX ABSX 


SAME 


PAGE 



Instruction 

-£rom previous 

Comment ^4tarts here 
Address 
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3. COMMANDS TO EDIT A PROGRAM 

4 * 

4 

New that we have explained how to get started writing a program/ 
it is up to you actually to write the program. This manual contains 
very little information on Assembly Language programming techniques. 

We assume that you are skilled in writing Assembly Language. The remainder 
of this section describes Editing Commands, not Assembly Language ins true 
tions . 

Ccmmands and instructions are distinguished. An instruction has 
a Line Number; a Command has no Line Number and is executed immediately. 

We did refer to "*=" as a Command, even though it is not executed immedi- 
ately and it must have a Line Number. It has the character of an obliga- 

* 

tory Directive. 



1/1 0/26/79/D . H . /23A 



NEW Co mmand 

* 

IWs Canmand dears the Edit Text better. After this Canmand 
you canrot restore any program that you had in the butter. 








__ 1 

* + 

j 


■ . 

I 

This Command displays on the screen the program in the Edit Text buffer. 

LIST (RETURN) displays the whole program* 

i 

LISTxx (RETURN) displays only line xx. | 

LISTxx,yy (RETURN) displays line xx to yy * ' 

- 

* 

I 

Using our sample program as an example: 

• »- ***■ 

* . % 

f * » 


EDIT 

LIST (RETURN) 


<0 

vp ore ? r*s aoc^ 

ww i ’.WJ UW1 i iTw-vi ( 

OCf"> VC A DACC 

^ i iwa vTh it. i 


TV iiki 

5* *© CCD 

wV Vi 4 i \u 

rp AC OV-*7"?yM 

W Hwvi i ■»w» 'T’T 

I v f it.v* ■«• • vV 

S3 .SD 


EDIT 

LIST20 (RETURN) 
20 REP LDX ABSX 



EDIT - 

LIST So, 70 (S5.Tu«*j) 

50 JMP REP 
60 ABSX=$3744‘* 

70 XEQ=*+$60 

EDIT 

B 




PRINT Command* 


This co mman d is the same as LIST, except that it prints Statements 
without Statement Numbers. 


Example: 


EDIT 

PRINT (RETURN) 
dtd f nv 

« -wi k>wi i ilvvi i 




- -** \ 


■ - * • 


v.- w-i- 


ocn vrr* caw o&rr 

. i iwa '-‘Til iw * n*.k« 


‘*7? 


■■ ^ i - ^ 

2/ 


IJK 

M? DTD 

•w» a i '-w 

A A 

nwwnNwi 17 

VC'VfrAtW 

I H-.a”' I* * T WV 

.BD 




a 

Q (RETURN) After using a PRINT Command, no further command 

can be entered until you press RETURN, which causes 
the EDIT message and cursor to be displayed. 

EDIT 

PRINT 20 (RETURN) 


REP LDX ABSX 

3 (RETURN) After using a PRINT Command, no further command 

can be entered until you press RETURN, which causes 
the EDIT message and cursor to be displayed. 

EDIT 

PRINT 40,60 
INX 

JMP REP 
ABSX=$3744 

H (RETURN) After using a PRINT Command, no further command 

can be entered until you press RETURN, which causes 
the EDIT message and cursor to be displayed. 


EDIT 

B 


FIND Command 

[ _ • v 

This Command finds a 
are shown below. 

FIND/SOUGHT/ (RETORN) 

* 

find/sought/xx { return ) 

* 

FIND/SOUGHT/xx ,yy,A 


39 

1 


specified string. The ways to write the Command 


finds the first occurrence of the string 
"SOUGHT" . The Statement that contains 
the string is displayed. 


finds the string "SOUGHT" if it occurs 
in Statement Number xx. Statement xx 
is displayed if it contains the string. 


Finds all occurrences of the string 
"SOUGHT" between Statement Numbers 
xx and yy. All the Statements that 
contain the string are displayed. 


4o 

» • 


DEL Comtiand- 


J 


s' 


This Ccmmand delete Statements fran the Edit Text buffer. 


i 

/ 




s b L ' ~ v 


t 




/ 


DELxx (RETURN) deletes Statement Number xx. 

DELxx ,yy (RETURN) deletes Statement Numbers xx to yy. 
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NUM Command 


This Canmand assigns Statement Numbers automatically. 


NUM (RETURN) increments Statement Number by 10 after each RETURN. 

The new Statement Number, followed by a space, 
is automatically displayed. 


NUMxx (RETURN) has the same effect as NUM, but the increment is 

xx instead of 10. 


NUMyy,zz (RETURN) forces the next Statement Number to be yy and the 

increment to be zz. 


(RETURN) cancels the NUM Canmand. 


CAUTION You cannot use the special keyboard editing keys to change 
other Statements while the NUM Command is in effect. You will succeed '/ 
in changing what appears on the screen, but, in an exception to the 
generaL rule, the contents of the Edit Text Buffer will not be changed. 







REN Comnand 


This Command renumbers Statements in the Edit Text Buffer. 



REN ' (RETURN) 


renumbers all the Statements in increments of xx , 
starting with 10. 



RENyy^i 


(RETURN) 


renumbers all the Statements in increments of zz, 
starting with yy. 











i 
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REP Command 


This Command replaces a specified string in the Edit Text Buffer with 
a different specified string. 


REP/OLD/NEW/ (RETURN) ' replaces the first occurrence of the 

string "OLD" with the string "NEW". ‘ 


REP/OLD/NEW/xx ,yy (RETURN) replaces the first occurrence of the 

string "OLD" between Statements Number 
xx to yy with the string "NEW". 


REP/OLD/NEW/ ,A ( RETURN ) 


replaces all the occurrences of the string 
"OLD" with the string "NEW". 


REP/OLD/NEW/xx, yy, A (RETURN) replaces all the occurrences of the 

string "OLD" between Statements xx to yy 
with the string "NEW". 


REP/OLD/NEW/xx, yy,Q (RETURN) 


displays, in turn, each occurrence 
of the string "OLD" between Statements 
Number xx and yy. 

To replace the displayed "OLD" with 
"NEW" , type Y. - To retain the displayed 
"OLD", press RETURN. - 
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4 COMMANDS TO SAVE AND RETRIEVE 

Commands associated with saving and retrieving a program or a 
block of memory are: 

LIST SAVE ''I 

I r a st>e.cvii c. \aU4c. oi memory 

ENTER V a program LOAD J 

ASM J 

These commands are similar in the way that their parameters are 
specified. They are also similar in that they cause data transfers 

f* 

between memory and long-term store. We distinguish, however, between 
commands that manipulate complete programs (LIST, ENTER, ASM) and com- 
mands that address specified memory locations. (SAVE, LOAD). 

LIST has already been described in one use, as an editing command, 
which is a special case of a more general concept* 

We have also mentioned ASM before, in Figure 3 and the section 
on WRITER/EDITOR and ASM. Its use is more versatile than simply calling 
the Assembler, as will be shown in this section. 

The commands ENTER, LOAD and SAVE have not been mentioned before. 

_ . •/ 

The commands LIST and ENTER are respectively for saving and retrieing 

programs, and they correspond to the commands to SAVE and LOAD a specific 

block of memory. 

While you are still developing a program, over several distinct 
sessions, you will have more occasion to use the LIST, ENTER and ASM 
commands. When your source program is satisfactory you will more 
often be working with the object program, using the SAVE and LOAD 
commands. 
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LIST Command 


)->— 'r ' 


y 


The cxnmiand LIST is used to save programs. If no device is 
specified in the command, the device "screen" is assumed. Possible 
devices are the TV screen (#S:), the Printer (#P:) the cassette (#C:) 
and the diskette ( #D: ) . The commands to transfer a program to these 


various devices are: 


"7 


LIST#S: 

LISTjfP: 

LIST#C: 

LIST#D:NAME 


(LIST#S: is the same as LIST) 




( CAUTION : Use cassette -handling procedures described in Users Manual) 
where "NAME" is an arbitrary name you give to the program. NAME 
must start with a letter and have no more than 8 characters, 
consisting of letters and numbers only. It may also have an 
extension of up to 3 characters. For example, NAME 3, ST5, 

JOHN. 23, PROP. 13 are all legal names. 


The forms of the commands to transfer only lines xx to yy to a device 

are: 

LISTS^S: ,xx,yy (LIST#S: ,xx,yy is the same as LIST,xx,yy) 

LIST#P:,xx,yy 

LIST#C: ,xx,yy (CAUTION: Use cassette-handling procedures described in Users Manual) 
LIST #D: NAME, xx, yy where "NAME" is an arbitrary name you give to the program. 

See the description above. 


CAUTION: The DOS makes sure that every file has a unique name by deleting 

old files if necessary. Therefore, do not name a file you are listing 
to diskette with the name of a file that is already stored on the diskette, 
unless you wish to replace the existing file with the one you are listing. 
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ENTER Command 


The Ccttmand aiTER is used to retrieve programs. As with the Command 

* 

LIST, a device has to be specified, in this case the device where the 
program is stored. There is only one device, the diskette, on which 
a named program is stored in a retrievable form. To retrieve a source 
program from diskette, the command is: 

if 

ENTER#D:NAME where "NAME" is the arbitrary name you gave to the program 

when you listed it on the diskette. 


To retrieve a source program from cassette, the command is: 

ENTERIC: (Follow the cassette— handling procedures give in your 

Users Manual.) 


Commands associated with saving and retrieving the contents of 
specific memory locations , rather than programs in the Edit Text Buffer, 
are SAVE and LOAD. They correspond to LIST and ENTER, respectively. 


SAVE Comnand 


ft 


/ “T 


A 


Y.i* r- 

*-* i-' 


^ 1 -6 • * 




tetri'- 

CJ 




^1. - T' 

/ O ■ / 
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The contents of a block of memory, locations xxxx to yyyy, on cassette 
or diskette, the commands are: 

SAVEfC: xxxx, yyyy 


SAVE #D: NAME xxxx, yyyy where NAME is an arbitrary name that you 

give to the block that you are saving. 


LOAD Command 


To retrieve the contents of the block of memory that you SAVED 
and which you named NAME the command is: 

IOADIC: (CAUTION: Use the cassette-handling procedures described 

in your Users Manual.) 

IDAD#D:NAME where "NAME" is the arbitrary name that you gave to the block 

when you saved it on diskette. 


These oonmands will reload the memory locations xxxx to yyyy with 
the contents that were previously SAVEd. The numbers xxxx and yyyy are 
those that were given in the original SAVE Command. 
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ASM Ce > m rr\«r\^' 

ASSFMRT iR COMMAND 

We now deal with the Assemble command, ASM. To assemble a program 

type 

ASM (RETURN) 

The Assembler then translates the source program iir 
the Edit Text Buffer, line by line in no more than- two passes, into machine 
code, writes the machine code into the memory locations that are specified 
in the source program and displays the assembled program on the TV screen. 
In transferring data between parts of the system, the Assembler uses 
Operating System facilities. 

In this example we specified no particular device where the source 
program would be found and no particular device where the program was to be 
listed or assembled. These are variables of the ASM command. When 
we do not specify the value of these variables, the Assembler 
proceeds with the standard or "default" values. That is, it finds 
the source program in the Edit Text Buffer, lists the assembled program 
on the TV screen and assembles the program into memory. You can override 
these standard decisions in the ASM command. 


The form of the command is, in general: 


-T 


! 

ASSEMBLE (Device where Source), (Device where assembled pro- , (Device where Object 

program located) gram will be listed) Code will be stored) 


The form of the oomnand, as written, is: 


n 


ASM? 1 #D:NAME1 


1 , 


) 



NAME 2 


} 


D Diskette 
P Printer 


"lI/10/26/79/dh/2 
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The form in which the command is written above is intended to 

convey that you will type cne alternative from each set of braces. 

For example: 

* 

ASM#D : LISTED , #P : , #D :OBJ 

» * 

0 

■ 

t 

That ooirmand takes the source program that you had previously 

listed on diskette and called "LISTED", assembles it and lists the assembled 

form on the Printer, and records on the diskette, with the new name "OBJ", 

the machine code translation of the source "LISTED". Note that commands 

of this form store the machine code on the diskette and not in computer 

memory. 

Sane other combinations are possible, but not useful. Sane of the 
combinations shown are not useful either. If you attempt an illegal 
combination, you will be given an error message. 
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To make a standard selection, enter a comma, as in the following 
useful command 

A SM , #P : 

That command takes the source program from the default Edit Text Buffer,, 
assembles and lists it on the Printer as before, and stores the machine 
code directly into the computer memory . 

CAUTION: You must be careful to specify a "safe” starting address 

at which to load the machine code into memory before executings 
the above command. (See *= Command) . If you try to assemble the 
program into Operating System memory, you will probably cause an 
Operating System failure. If that happens and you have to switch 
off your computer, you will, of course, lose the program in the 
Edit Text Buffer, and you will have to enter it again. 

In the next example only the final parameter is specified, 
and the first two have default values: 

ASM, , #D:0BJ2 

That command takes the source program from the Edit Text Buffer, 
lists it on the screen and records on diskette the machine code 
object program under the name ,, 0BJ2 il . You can later retrieve 
QBJ2 from diskette with the following command 

LOAD #D:0BJ2 

/ 

The effect of the command is to load the appropriate memory locations, 
as specified in the original source program, using the assembled object 
program on the diskette as the source of the information. 
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5 DIRECTIV ES (PSEUDO OPERATIONS ) 

Directives are instructions to the Assembler. Directives do not, in 
general, produce any assembled code, but they affect the way the Assembler 
assembles other instructions during the assembly process. Directives are 
also called pseudo operations or pseudo ops. 

Directives are identified by the Assembler by the "."at the beginning. 
The only exception is the = Directive, which starts with a Label or *. 

You will remember that in the section on getting started we called the 
command "*=" an obligatory Directive. 

A Directive must have Line Numbers, which it follows by at least two 
spaces. 


OPT Directive 


This Directive specifies an option. There are four sets of 
options . These are : 

.OPT NOLIST 

.OPT LIST (this one is the default condition) 

.OPT NOOBJ 

.OPT CBJ (this one is the default condition) 

.OPT NOERR 

.OPT ERR (this one is the default condition) 

.OPT NOEJECT 

.OPT EJECT (this one is the default condition) 
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The second listed of each pair represents the standard or default 
condition. Therefore, an option pair, when used, always appears in the 
program in the carder shown, with, for example, .OPT NOOBJ occurring 
before .OPT CBJ. The first member of each pair might also occur cn 
its own, without the default option being re-imposed before the end 
of the program. 


100 .OPT NOLIST 
(part of source 
program ) 

200 .OPT LIST 


The effect of these Directives is to emit from 
the listed form of the assembled program the lines 
between lines 100 and 200. (These line numbers 
are arbitrary. ) 


100 .OPT NOOBJ 
(part of source 
program) 

200 .OPT CBJ 


The effect of these Directives is to emit fran 
the machine code form of the assembled program 
the lines between lines 100 and 200. 


100 .OPT NOERR 
(part of source 
program) 

200 .OPT ERR 


The effect of these Directives is to emit error 
messages for the assembled program lines between 
lines 100 and 200. 


100 .OPT NOEJECT 
(part of source 
program) 

200 .OPT EJECT 


The effect of these Directives is to suppress, 
between lines 100 AND 200, the 4-line page 
spacing that is normally inserted after every 
56 lines of the listed form of the assembled 
program. 
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TITLE AND PAGE DIRECTIVES 


We explain these Directives together because they are intended 

- * ^ 

to be used together to provide easily read in 

' i 

\ * . . 

assembled program. ' : ' - 


ormation about- the 


These Directives are. most useful when the assembled program is 
listed on the Printer. - 


PAGE allow you to divide your program listing into 
bear messages written .. 

~ nam o d fo r yom — coiiyenieiu.? - for your own ' 

much as you might add short explanatory notes to 


any complex material 


The PAGE Directive 


causes the Printer to put out (4/ blank 1 
followed by the messages you have given for TITLE and PAGE , - fo - llo 
■by unuLlurr" blank rifleT. This causes the messages to sta^ ou 
somewhat from the rest, of the assembled program listing. The^; ftv 
TITLE message^is always- the same, and the PAGE message can be dif 


Tou would usually have only one TITLE Directive, giWing, say, the program name and 
date, and different BAGS Directives for . giving different page messages. Then 
On listing the assembled program the TITLE message on every page would be xhe san» 
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yhi la ft ha page message^ w e ^A ^ dif^c g. ' 
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To illustrate, let us add to our small program^the Directives TITLE and PAGE 
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TAB DIRECTIVE 


The TAB Directive sets the fields of the Statement as they appear 
when assembled and listed cn the screen or the Printer. Let us use the 
specific example of Statement 30 of the small sample program we used 
for illustration before. It was written as follows: 

20 ... 

30 BEQ XEQ SAME PA® 

40 ... 

Note that cne space, rather than a tab, is used between each field. 
Using spaces rather than tabs lets you write longer programs, since the 
Edit Text Buffer will not be filled up with the extra spaces that 
would require . 

Canpressing the program in this way makes it less easily readable 
than we might wish, but we can use the TAB Directive to give us a more 
readable assembled version. The form of the Directive is 
xxx .TAB 10,15,20 


II/10/26/79/D.H./6 




The effect of the TAB Directive of line xxx is confined to the appearance of 

lines following xxx when they ;are assembled and listed on the Printer or screen 

\ ■ \ 


T . , - , . on the Printer 

In the case of line 30, the appearance would be as 

below: 


shown 
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3003 F064 30 


BEQ XEQ SAME PAGE 
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IS 
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If the TAB Directive is not used, then the appearance ^of the assembler 

^ \ * . 

line on the Printer will be as shown below: <? 
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The appearance of^ the screen will be different only because 
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has 36 characters positions, while the Printer has 40. 


the s creei 


V : J 


■ ^ 1 " 




n . ■ , > • 




f * 

•f ' . 


r 


, A 


. - ■ ■ % r - - 

- •» # „ 


. v 

- ?£• 


'i . • V - 


-'*• - -k * 


\ 

9 


- ‘ ^ ' 1 * - 




V. . 






/% 
,/ * 




. ■** • 


-/ 




■ ^ 


V ■ I t 


f 

I 


BYTE, DBYTE AND WDRD Directives 


These Directives are similar in that they are used to insert 
data rather than instructions into the proper places in the 
program. Each Directive is slightly different in the manner in 
which it inserts data. 


BYTE Directive 


The BYTE Directive reserves a location (at least one) in memory. 
The Directive essentially increments the Program Counter to leave 
space in memory to be filled by information required by the program. 
The Operand supplies the information directly. 

Examples: 

10 

20 .BYTE 34 
30 

Here, the Assembler assembles into successive locations the instruction 
of line 10, then the number 34, then the instruction of line 30. 


* I 


* 


10 

20 .BYTE 34,56,78 
30 


Here, the Assembler assembles into successive locations the 

* 

instruction of line 10, then the numbers 34, 56 and 78, then the 
instruction of line 30. The Operand may be an expression more 
complex than the numbers used in the examples. The rules for writing 
and evaluating an expression are given in Appendix D. 


10 

20 .BYTE "ATARI" 

30 

Here, the Assembler assembles into successive locations the 
instruction of line 10, then the (ATASCII) hex numbers 41, 54, 41, 52 and 
49, then the instruction of line 30. 


l.b.12 



I 


I 

a 

PBYTE DIRECTIVE 

The PBYTE Directive reserves two locations for each expression 
in the operand. The value of the expression is assembled with the 
high-order byte first (in the lower numbered location). For example 

10 *=$4000 

20 . EBYTE ABS+$3000 

When line 20 is assembled and the value of ABS + $3000 is determined 

to be (say) 5123 ,51 is put in location 4000 and 23 is placed put in 
location 4001. 

WORD DIRECTIVE 

The Word Directive is the same as the DBYTE Directive except that 

the value of the expression is stored with the low-order byte first. 

For example : 

10 *=$4000 

20 .WORD ABS*$3000 

When line 20 is assembled and the value of ABS + $3000 is determined, 

as before, to be 5123, 23 is put in location 4000 and 51 is put in location 
4001. 

The WORD Directive simplifies some programming since addresses 
in machine code are always given in the order low-byte followed by 
high byte. Therefore, the WORD Directive is useful, for example, 
constructing a table of addresses. 
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= Directive 


The = Directive is used to give a value trj a label. Two examples 
appear in the sample program we used before. Statements 60 and 70 
give values to ASSX and XEQ, as follows: 

60 ABSX=$3744 
70 XEQ=*+$60 

0 

Since the symbol that is given a value is a Label, there must be 
only one space after the Statement Number. The expression on the right 
cannot have a value greater than FFFP (hex). The rules for writing and 
evaluating an expression are given in Appendix D. 

When the = Directive is used to give a value to a Label, the Label 
can be used in an Operand, by itself, as in statements 20 and 30 in 
the sample program. 

A defined Label may also appear as part of an expression. Our 

* 

sample program does not contain an example, so we give one below, 
in line 240 

100 TAB 1=$ 3000 


240 TAB2=TA31+$20 

When the program is assembled, TAB2 will be given the value $3020. 

You should note that defining a label in this way gives the ' 
label a specific address; it does not define the contents of the 
address. In the exanple, above, TAB1 and TAB 2 might be the location • 
of two tables, that contained the values of variables that your 
P rogram required. 


We also encountered the = Directive in the Getting Started Commands, 
where it is used to set the starting location of the assembled program. 

In that case we defined the value of the Current Location Counter ( 1 * 1 # 

rather than a Label. Minimal statements of the two uses of the = Directive 

* 

are given below. Note that /there must be '* * . 

exactly one space before AB and at least two spaces before *. 


10 AB=Expression 
10 *=Expression 


END DIRECTIVE 


Every program should have one and only one END Directive. It tells 
the Assembler to stop assembling. It is not always essential, but it is 
good practice to use this Directive. 




I 



DEBUGGING. 

* ' « v 

1. PURPOSE OF DEBUGGER 

Ihe Debugger allows you to follow the operation of a program in 
detail and to determine the effects of minor changes in it. 

The operation of the program is shown in both machine language and 

9 

Assembly Language. A knowledge of machine langage is helpful when you 
use the Debugger, but it is not essential. The Debugger is able to 
convert machine code into Assembly Language (disassemble), so you can 
make oode alterations at the level of particular memory locations and 

be informed of the effects by the Debugger in Assembly Language. 

( 

2. CALLING THE DEBUGGER 

The Debugger is called from the WRITER/EDITOR by typing 
BUG (RETURN) 

This produces on the screen 
DEBUG 

B 

The command to return to the WRITER/ED ITOR is 
X (RETURN) 
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3. DEBUG COMMANDS 

The Debug oommands are listed below. In this list "xxxx" indicates 
that the form of the command must include memory adress(es). The actual 

method of specifying the memory adress(es) is shown in the examples 
given later in this section. 


DR 

Display Registers 

CR 

Change Registers 

Dxxxx 

Display Memory 

Cxxxx 

Change Memory 

Mxxxx 

Move Memory 

Vxxxx 

Verify Memory 

Lxxxx 

List Memory 

Axxxx 

Assemble Memory 

Txxxx 

Trace Operation 

Sxxxx 

Single-step Operation 

Gxxxx 

Go (Execute Program) 

X 

Return to WRITER/EDITOR 


(BREAK) Pressing the BREAK key halts certain operations. 


We now give several examples showing how to use the commands. 

In the examples, the lines ending with "(RETURN)" are entered on the 

keyboard. The other lines show the response of the system, as displayed 
on the screen. 
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DR Display Registers 
Example: 

# 

EDIT 

BUG (RETURN) 

4 

DEBUG 

DR ( RETURN) 

A=BA X=12 Y=34 P=BO S-DE 

DEBUG 

H 


The registers and contents are displayed as shown. A is the Accumulator 
X and Y are the Index Registers, P is the Processor Status Register and S is 
the Stack Pointer* 


CR Change Registers 


Example : 

EDIT 

BUG (RETURN) 

DEBUG 

CR<1,2,3,4,5 (RETURN) 
DEBUG 

a 


The effect of the command above is to set the contents of the Registers 
A, X, Y, P and S to 1, “2, 3, 4 and 5* 

You can skip Registers by using commas after the . For example, 

CR<, ,,,E2 (RETURN) 

sets the Stack Pointer to E2 and leaves the other Registers unchanged*: 
Registers are changed in order up to RETURN. For example, 

CR<, 34 (RETURN) 

sets the X Register to 34 and leaves the other Registers unchanged. 



Dxxxx,yyyy where yyyy where yyyy< xxxx shows the contents of address 

xxxx. 

Example: 

DEBUG 

D5000,0 (RETURN) 

5000 A9 
DEBUG 


This shows that address 5000 contains the number A9. 


If the second address (yyyy) is emitted, the contents of 8 successive 
locations are shown. The process can be continued by typing D (RETURN)'. 

Example : 

DEBUG 

D5000 (RETURN> 

* 

5000 A9 03 18 E5 F0 4C 23 91 

DEBUG 

D (RETURN) 

5008 18 41 54 41 52 49 20 20 

DEBUG 

i 


Dx xxx, yyyy where yyyy > xxxx, shows the contents of addresses xxxx 
to yyyy. 


Example: 

DEBUG 

D50Q0,500F (RETURN) 

5000 A9 03 18 E5 F0 4C 23 91 

5008 18 41 54 41 52 49 20 20 

DEBUG 

I 


The display can be stopped by pressing the BREAK key. 
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Cxxxx Change Memory 

Cxxxx<yy changes the contents of address xxxx to yy 

Example : 

DEBUG 

C500K23 (RETURN) 

DEBUG 

a 

< > 

* / 

■ 

The effect of the command is to put the number 23 in location 5001 , 

A comma increments the location to be changed. 

Example: 

DEBUG 

C500B<21,EF (RETURN) 

DEBUG 

C700B<31,,,87 (RETURN) 

DEBUG 

a 

The first command puts 21 and EF in locations 500B and 500C respec- 
tively. 

The second command puts 34 and 87 in locations 700B and 700E respec- 
tively. 
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Mxxxx Move 

— J 

♦ 

Mxxxx <yyyy,zzzz copies memory for yyyy-zzzz to memory starting 
at xxxx. Address must be less than yyyy or greater then 3333. 

Example: 

DEBUG 

M1230<5000,500F (RETURN) 

, t 

DEBUG 

§ 

The corrmand oopies the data in location 5000-500F to locations 1230- 

123F. 

Vxxxx Verify Memory 

Vxxxx<yyyy,zzzz compares memory yyyy-zzzz with memory starting at 

xxxx and shows mismatches. 

Example: 

DEBUG 

V7000<7100,7123 (RETURN) 

DEBUG 

B 

The command compares the contents of 7100-7123 with the contents of 

7000-7023. There were no mismatches. 

Mismatches are shown as follows: 

7101 00 7001 22 

7105 18 7005 10 



II/10/26/79/D.H./16 


Lx xxx List Memory with Disassembly 


form. 


This command allows you to look at any block of memory in disassembled 


Examples : 

7000 (RETURN) 


L (RETURN) 


L7000,0 (RETURN) 
L7000,7000 (RETURN) 
L7000,6000 (RETURN) 


List a screen page (20 line of code) 
starting at memory location 7000. 
Pressing the BREAK key during listing 
halts the listing* 

This form of the command lists a screen 
page starting ^t the instruction last 
shown, plus -ene 1. 

These forms list the instructions at 
address 7000 only. 


L345,567 (RETURN) This form lists address 345 through 567 

Only the last 20 instructions will 
actually be visible at the completion 
of the response of the system. 


The command Lxxxx differs from Dxxxx in that Lxxxx disassembles the 
contents of memory. 

Example: 

EDIT 

BUG (RETURN) 

DEBUG 

L5000,0 (RETURN) 

5000 A9 03 #$03 

DEBUG 

B 

This exanple shows that the Debugger examined the oontents of 
memory address 5000 and disassembled A9 to LDA. Since A3 must have a 
one-byte Operand, the Debugger made the next byte (the contents of address 
5001) the operand. Therefore, although the Debugger was only "asked" 
for the content of location 5000, it showed a certain amount of intelli- 
gence and replied by showing the instruction that started at address 
5000. 
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To illustrate this further, the number 03 corresponds to no machine 
code instruction, so the Debugger would interpret 03 as an illegal instruc- 
tion, and alert you to a possible error, as shown below. 

DEBUG 

L5001,0 (RETURN) 

5001,03 ??? 

* 

DEBUG 

However, if the first instruction you wrote were IDA $8A, then you 
would have obtained the following, apparently incons is tent ? results while 
debugging: 

✓ 

DEBUG 

L5000,0 A9 8A LDA #$8A 

DEBUG 

1*5001,0 . 8A TXA 

Because the disassembler starts disassembling from the first address 
you specify, you have to take care that the first address corresponds 
to the contains the first byte of a "real" instruction. 
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A Assemble 

« 

Hie DEBUGGER in has a "miniassembler" , that can' assemble cne instruc- 
tion at a time. To enter the Assemble mode, type 

A (RETURN) 

Once in the Assemble mode, you stay there until you wish to return 
to DEBUGGER, which you may do by pressing RETURN. 

To assemble an instruction, first enter the address at which you wish 
to have the machine code inserted. The number that you enter will be inter- 
preted as a hex address. Now type "<" followed by at least cne space, then 
the instruction. 

Example: 

EDIT 

BUG (RETURN) 

DEBUG 

A (RETURN) 

5001< IDY $1234 (RETURN) 

5001 AC3412 

5004< INY (RETURN) 

5004 C8 

B (RETURN) 

« 

DEBUG 

B 

Since the mini -assembler assembles only one instruction at a time, it 
cannot refer to another instruction. Therefore, it cannot interpret a Label. 
Consequently, Labels are not legal in the mini-assembler. 

You can use the Directives BYTE, DBYTE AND WORD. 
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Gxxxx Go (Execute Program) 

r 

This command executes instructions starting at xxxx. 

For example: 

* * 

G7B00 (RETURN) Executes instructions starting at location 7B00. 

Execution continues indefinitely. Execution is 
stopped by pressing the BREAK key. 


Txxxx Trace Operation 

^ a 

This command has the same effect as Gxxxx, except that after execution 
of each instruction the screen shows the instruction address, the instruction 
in machine code, the instruction in Assembly Language (disassembled by 
the Debugger — not ; necessarily the same as you wrote it in Assembly 

Langauge) and the values of Registers A, X, Y , P and S. 

The execution* stops at a BRK instruction (machine code 00) and when you press the 
BREAK key on the keyboard. 


Example: 

DEBUG 

T&000 (RETURN) 


ffooo 

A9 

03 

LDA 

#$03 

V A=03 

X=02 

Y=03 

P=34 

s=05 

5002 

18 


CLC 


A=03 

X=02 

Y=03 

P=34 

S=05 

; 5oo3 

E5 

F0 

SBC 

$F0 

A=03 

X=02 

Y=03 

■ P=34 

S=05 

Soos 

4C 

23 71 

JMP 

$fl23 

A=03 

X=02 

Y=03 

P=34 

S=05 

*1123 , - 

00 



BRK 


A=0§ ' 

X=02 

Y=03; 

P=B4 

S=05 

DEBUG 


v. 





Sxxxx S tep Operation 

-■■■ — * ~ * 

This command has the same effect as Txxxx, except that cnly one 
instruction is executed. To step through a program type S (RETURN) 
repeatedly after the first oomnand of Sxxxx (RETURN). 



X Exit 

To return to the WRITER/EDITOR enter 
X (RETURN) 
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APPENDIX. This table to be set to cover a page. It shoud 
be easy to read. There will probably be no more than 1/4 page 
of explanatory text. 
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APPENDIX . 
MEMORY MAP 


F F Ff 


Hooo 

P£>do 

Cooo 


Ai>0O 


0OOO 


Operating 

System 

ROM 

I/O ROM 

Not used 

Cartridge 
Slot. A 

Cartridge- 
Slot B 


Unu^e/ 


2%>oq 


0700 L 


DOS and 
FMS RAM 

OS RAM 


RAM available to user if system 
lacks diskette drive. 


07-00 


Of OO 
00 FB 


O0B0 


ooeo 


Stao< 

used by^ 

(J nos*-dl 

(See n&fe^ 

By 


Note 


The map shows have the Assembler Cartridge inserted 

/\^ rie Page Zero RAM available to you if you^are executing^ssembly Langage program. 
If you have the BASIC Cartridge inserted, and you are using a BASIC program 
to call an Assembly Language routine, then^tss Page Zero RAM^available to you, 

{on ly 6 by t e s of"} ^ 


namely OOCB to OODl. 
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ERRORS 


the TV speaker is given a short "beep" and 


When an error occurs ,jThe error number is displayed. 

Errors numbered less than 100 refer to the Assembler Cartridge 


ERROR 

NUMBER 


1. The memory available is insufficient for the program to be assembled. 

2. For the Command "DEL xX/yy" the number xx cannot be found. * 

3. There is an error in specifying an address. (Mini-assembler) 

4. The file named cannot be loaded. 

5. Undefined reference. 

6. Error in syntax of a statement. 

7. Lable defined more than once, inconsistently. 

8. Buffer overflow. 

9. There is no label before . 

10. The value of an expression is greater than 255. 

11. A null string has been used. 

. 

12. The address or address type specified is incorrect. 

13. Phase error. An inconsistent result has been found from Pass 1 
to Pass 2. 

14. Undefined forward reference. 

15. Line is too large. 

16. Assembler does not recognize the source statement. 

17. Line number is too large. 

18. LOMEM Command was attempted after other command (,s) or 
instruction (s) . LOMEM/ if used/ must be the first command. 
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APPENDIX 

, t 

ERRORS 

Errors numbered more than 100 refer to the Operating System and the Disk Operating 
System. For a complete list of DOS errors, refer *co the DOS manual. 

128 You hit the BREAK key during an I/O operation. 

130 You specified a.non-existent device;; 

132 The command is invalid for the device. 

136 EOF. End of file read has been reached. This error 

may occur when reading from cassette. 

137 A record was longer than 256 characters. 

138 The device specified in the command does not respond. 

Wake sure the device is connected to the consol and powered. 

139 The device specified in the command does not return an 
Acknowledge signal. , 

140 Serial framing error. 

142 Serial framing error 

143 Serial data checksum error 

144. Device done error 

145 Diskette error — read-after-write comaprison failed. 

146 

162 R xxax Disk full. 

* 

165 File name error 
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SPECIAL SYMBOLS (cont'd) 

Register names: 

A 

X 

Y 

S 

P 


ASSEMBLER Mnemonics 


list in colums alphabetically 


MCS6501-MCS6505 MICROPROCESSOR INSTRUCTION SET - ALPHABETIC SEQUENCE 


^-2— t 


II 


ADC Add Memory to Accumulator with Carry 
AND "AND" Memory with Accumulator 
ASL Shift Left One Bit (Memory or Accumulator) 

BCC Branch on Carry Clear 

BCS Branch on Carry Set 

BEQ Branch on Result Zero 

BIT Test Bits in Memory with Accumulator 

BMI Branch on Result Minus 

BNE Branch on Resuit not Zero 

BPL Branch on Result Plus 

BRK Force Break 

BVC Branch on Overflow Clear 

BVS Branch on Overflow Set 

CLC Clear Carry Flag 

CLD Clear Decimal Mode 

CLI Clear Interrupt Disable Bit 

CLV Clear Overflow Flag 

CMP Compare Memory and Accumulator 

CPX Compare Memory and Index X 

CPY Compare Memory and Index Y 

DEC Decrement Memory by One 
DEX Decrement Index X by One 
DEY Decrement Index Y by One 

EOR "Exclusive Or” Memory with Accumulatoi 
INC Increment Memory by One 

INX Increment Index X by One 

INY Increment Index Y by One 

JMP Jump to New Location 


JSR Jump to New Location Saving Return Address 


LDA 

LDX 

LDY 

LSR 


PHA 

PHP 

PLA 

PLP 

ROL 

ROR 

RTI 

RTS 

SBC 

SEC 

SED 

SEI 

STA 

STX 

STY 

TAX 

TAY 

TSX 

TXA 

TXS 

TYA 


Load Accumulator with Memory 

Load Index X with Memory 

Load Index Y with Memory 

Shift Right One Bit (Memory or Accumulator) 


NOP No Operation 

ORA "OR" Memory with Accumulator 


Push Accumulator on Stack 
Push Processor Status on Stack 
Pul| Accumulator from Stack 
Pull Processor Status from Stack 

Rotate One Bit Left (Memory or Accumulator) 
Rotate One Bit Right (Memory or Accumulator) 
Return from Interrupt 
Return from Subroutine 

Subtract Memory from Accumulator with Borrow 

Set Carry Flag 

Set Decimal Mode 

Set Interrupt Disable Status 

Store Accumulator in Memory 

Store Index X in Memory 

Store Index Y in Memory 

Transfer Accumulator to Index X 
Transfer Accumulator to Index Y 
Transfer Stack Poirier to Index X 
Transfer Index X to Accumulator 
Transfer Index X to Stack Pointer 
Transfer Index Y to Accumulator 



APPENDIX 


» 


SPECIAL SYMBOLS 


Below we give a list of special symbols that have a restricted meaning to 
the Assembler. You should avoid using these symbols as a matter of course. 

l^ost attempts to use these symbols in any but their special sense will 

/ 

/ 

/ 

result in errors. They may be used, without their special meaning, 

i 

in comments and in the operands of memory reservation Directives 
(.BYTE, .WORD). 


; The semicolon is used to indicate the start of a comment. Everything 
between the semicolon and RETURN appears in the listed form of the 
program and is ignored by the Assembler.. When comments take more than 
one line, start each new line with a semicolon. 

« 

# The # sign is used as the first symbol of an immediate operand, as ' a 
in LDX #24 

$ The $ sign is used before numbers to signify that they are to be 
interpreted as hex numbers. For example, LDX #$34 


The asterisk is used to signify the value of the current location 
counter. For example, the inctrnrt"’ o 8 following line gives the 

symbol HERE a value equal to 5 more than the number in the current 
location counter: ■ 


20^HERE=*+5 


Example : 

1©0 U8 *=$911 

\ Vo yS 
Uo yb 
!3o yL 


PLA 

*=*+$F 

TAX 




Iji Llilta tAandpie , aCociiiblmg — lme LB cansHs the — to cations — c ounte r — to bi 
$0 9 11 


loo 

When this example is assembled, line causes the location counter to be 
$0911, PLA is placed in location $0911, lineJ20 causes the location 
gounter to be increased from $0912 to $0921, and TAX is placed in 
$0921. 






















